<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GimpPropWidgets: GIMP 3 Widgets Library Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GIMP 3 Widgets Library Reference Manual">
<link rel="up" href="libgimpwidgets-utils.html" title="Part VI. GIMP Widgets Utilities">
<link rel="prev" href="libgimpwidgets3-GimpEnumWidgets.html" title="GimpEnumWidgets">
<link rel="next" href="libgimpwidgets3-GimpWidgets.html" title="GimpWidgets">
<meta name="generator" content="GTK-Doc V1.33.0 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#libgimpwidgets3-GimpPropWidgets.description" class="shortcut">Description</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="libgimpwidgets-utils.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="libgimpwidgets3-GimpEnumWidgets.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="libgimpwidgets3-GimpWidgets.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="libgimpwidgets3-GimpPropWidgets"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="libgimpwidgets3-GimpPropWidgets.top_of_page"></a>GimpPropWidgets</span></h2>
<p>GimpPropWidgets — Editable views on <span class="type">GObject</span> properties.</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="libgimpwidgets3-GimpPropWidgets.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-boolean-combo-box-new" title="gimp_prop_boolean_combo_box_new ()">gimp_prop_boolean_combo_box_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-boolean-radio-frame-new" title="gimp_prop_boolean_radio_frame_new ()">gimp_prop_boolean_radio_frame_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-check-button-new" title="gimp_prop_check_button_new ()">gimp_prop_check_button_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-color-area-new" title="gimp_prop_color_area_new ()">gimp_prop_color_area_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-coordinates-connect" title="gimp_prop_coordinates_connect ()">gimp_prop_coordinates_connect</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-coordinates-new" title="gimp_prop_coordinates_new ()">gimp_prop_coordinates_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-entry-new" title="gimp_prop_entry_new ()">gimp_prop_entry_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-pointer-combo-box-new" title="gimp_prop_pointer_combo_box_new ()">gimp_prop_pointer_combo_box_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-enum-check-button-new" title="gimp_prop_enum_check_button_new ()">gimp_prop_enum_check_button_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-enum-combo-box-new" title="gimp_prop_enum_combo_box_new ()">gimp_prop_enum_combo_box_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-enum-label-new" title="gimp_prop_enum_label_new ()">gimp_prop_enum_label_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-enum-radio-box-new" title="gimp_prop_enum_radio_box_new ()">gimp_prop_enum_radio_box_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-enum-radio-frame-new" title="gimp_prop_enum_radio_frame_new ()">gimp_prop_enum_radio_frame_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-enum-icon-box-new" title="gimp_prop_enum_icon_box_new ()">gimp_prop_enum_icon_box_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-expander-new" title="gimp_prop_expander_new ()">gimp_prop_expander_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-file-chooser-button-new" title="gimp_prop_file_chooser_button_new ()">gimp_prop_file_chooser_button_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-file-chooser-button-new-with-dialog" title="gimp_prop_file_chooser_button_new_with_dialog ()">gimp_prop_file_chooser_button_new_with_dialog</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-hscale-new" title="gimp_prop_hscale_new ()">gimp_prop_hscale_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-icon-image-new" title="gimp_prop_icon_image_new ()">gimp_prop_icon_image_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-int-combo-box-new" title="gimp_prop_int_combo_box_new ()">gimp_prop_int_combo_box_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-int-radio-frame-new" title="gimp_prop_int_radio_frame_new ()">gimp_prop_int_radio_frame_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-int-radio-box-new" title="gimp_prop_int_radio_box_new ()">gimp_prop_int_radio_box_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-label-new" title="gimp_prop_label_new ()">gimp_prop_label_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-memsize-entry-new" title="gimp_prop_memsize_entry_new ()">gimp_prop_memsize_entry_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkAdjustment.html#GtkAdjustment-struct"><span class="returnvalue">GtkAdjustment</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-opacity-entry-new" title="gimp_prop_opacity_entry_new ()">gimp_prop_opacity_entry_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-path-editor-new" title="gimp_prop_path_editor_new ()">gimp_prop_path_editor_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkAdjustment.html#GtkAdjustment-struct"><span class="returnvalue">GtkAdjustment</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-scale-entry-new" title="gimp_prop_scale_entry_new ()">gimp_prop_scale_entry_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-size-entry-new" title="gimp_prop_size_entry_new ()">gimp_prop_size_entry_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-spin-button-new" title="gimp_prop_spin_button_new ()">gimp_prop_spin_button_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-string-combo-box-new" title="gimp_prop_string_combo_box_new ()">gimp_prop_string_combo_box_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-switch-new" title="gimp_prop_switch_new ()">gimp_prop_switch_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkTextBuffer.html#GtkTextBuffer-struct"><span class="returnvalue">GtkTextBuffer</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-text-buffer-new" title="gimp_prop_text_buffer_new ()">gimp_prop_text_buffer_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-unit-combo-box-new" title="gimp_prop_unit_combo_box_new ()">gimp_prop_unit_combo_box_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="libgimpwidgets3-GimpPropWidgets.description"></a><h2>Description</h2>
<p>Editable views on <span class="type">GObject</span> properties.</p>
</div>
<div class="refsect1">
<a name="libgimpwidgets3-GimpPropWidgets.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gimp-prop-boolean-combo-box-new"></a><h3>gimp_prop_boolean_combo_box_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_boolean_combo_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                                 <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                                 <em class="parameter"><code>const <span class="type">gchar</span> *true_text</code></em>,
                                 <em class="parameter"><code>const <span class="type">gchar</span> *false_text</code></em>);</pre>
<p>Creates a <a href="https://developer.gnome.org/gtk3/GtkComboBox.html#GtkComboBox-struct"><span class="type">GtkComboBox</span></a> widget to display and set the specified
boolean property.  The combo box will have two entries, one
displaying the <em class="parameter"><code>true_text</code></em>
 label, the other displaying the
<em class="parameter"><code>false_text</code></em>
 label.</p>
<div class="refsect3">
<a name="gimp-prop-boolean-combo-box-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of boolean property controlled by combo box.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>true_text</p></td>
<td class="parameter_description"><p>Label used for entry corresponding to <code class="literal">TRUE</code> value.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>false_text</p></td>
<td class="parameter_description"><p>Label used for entry corresponding to <code class="literal">FALSE</code> value.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-boolean-combo-box-new.returns"></a><h4>Returns</h4>
<p>The newly created <a href="https://developer.gnome.org/gtk3/GtkComboBox.html#GtkComboBox-struct"><span class="type">GtkComboBox</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-boolean-radio-frame-new"></a><h3>gimp_prop_boolean_radio_frame_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_boolean_radio_frame_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                                   <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                                   <em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>,
                                   <em class="parameter"><code>const <span class="type">gchar</span> *true_text</code></em>,
                                   <em class="parameter"><code>const <span class="type">gchar</span> *false_text</code></em>);</pre>
<p>Creates a pair of radio buttons which function to set and display
the specified boolean property.
If <em class="parameter"><code>title</code></em>
 is <code class="literal">NULL</code>, the <em class="parameter"><code>property_name</code></em>
's nick will be used as label
of the returned frame.</p>
<div class="refsect3">
<a name="gimp-prop-boolean-radio-frame-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of boolean property controlled by the radio buttons.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>title</p></td>
<td class="parameter_description"><p>Label for the frame. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>true_text</p></td>
<td class="parameter_description"><p>Label for the button corresponding to <code class="literal">TRUE</code>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>false_text</p></td>
<td class="parameter_description"><p>Label for the button corresponding to <code class="literal">FALSE</code>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-boolean-radio-frame-new.returns"></a><h4>Returns</h4>
<p>A <a class="link" href="GimpFrame.html" title="GimpFrame"><span class="type">GimpFrame</span></a> containing the radio buttons. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-check-button-new"></a><h3>gimp_prop_check_button_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_check_button_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                            <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                            <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
<p>Creates a <a href="https://developer.gnome.org/gtk3/GtkCheckButton.html#GtkCheckButton-struct"><span class="type">GtkCheckButton</span></a> that displays and sets the specified
boolean property.
If <em class="parameter"><code>label</code></em>
 is <code class="literal">NULL</code>, the <em class="parameter"><code>property_name</code></em>
's nick will be used as label
of the returned button.</p>
<div class="refsect3">
<a name="gimp-prop-check-button-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of boolean property controlled by checkbutton.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>Label to give checkbutton (including mnemonic).</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-check-button-new.returns"></a><h4>Returns</h4>
<p>The newly created <a href="https://developer.gnome.org/gtk3/GtkCheckButton.html#GtkCheckButton-struct"><span class="type">GtkCheckButton</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-color-area-new"></a><h3>gimp_prop_color_area_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_color_area_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                          <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                          <em class="parameter"><code><span class="type">gint</span> width</code></em>,
                          <em class="parameter"><code><span class="type">gint</span> height</code></em>,
                          <em class="parameter"><code><a class="link" href="GimpColorArea.html#GimpColorAreaType" title="enum GimpColorAreaType"><span class="type">GimpColorAreaType</span></a> type</code></em>);</pre>
<p>Creates a <a class="link" href="GimpColorArea.html" title="GimpColorArea"><span class="type">GimpColorArea</span></a> to set and display the value of an RGB
property.</p>
<div class="refsect3">
<a name="gimp-prop-color-area-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of RGB property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>Width of color area.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>Height of color area.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>type</p></td>
<td class="parameter_description"><p>How transparency is represented.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-color-area-new.returns"></a><h4>Returns</h4>
<p>A new <a class="link" href="GimpColorArea.html" title="GimpColorArea"><span class="type">GimpColorArea</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-coordinates-connect"></a><h3>gimp_prop_coordinates_connect ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_prop_coordinates_connect (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                               <em class="parameter"><code>const <span class="type">gchar</span> *x_property_name</code></em>,
                               <em class="parameter"><code>const <span class="type">gchar</span> *y_property_name</code></em>,
                               <em class="parameter"><code>const <span class="type">gchar</span> *unit_property_name</code></em>,
                               <em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *sizeentry</code></em>,
                               <em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *chainbutton</code></em>,
                               <em class="parameter"><code><span class="type">gdouble</span> xresolution</code></em>,
                               <em class="parameter"><code><span class="type">gdouble</span> yresolution</code></em>);</pre>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-coordinates-new"></a><h3>gimp_prop_coordinates_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_coordinates_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *x_property_name</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *y_property_name</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *unit_property_name</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *unit_format</code></em>,
                           <em class="parameter"><code><a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy"><span class="type">GimpSizeEntryUpdatePolicy</span></a> update_policy</code></em>,
                           <em class="parameter"><code><span class="type">gdouble</span> xresolution</code></em>,
                           <em class="parameter"><code><span class="type">gdouble</span> yresolution</code></em>,
                           <em class="parameter"><code><span class="type">gboolean</span> has_chainbutton</code></em>);</pre>
<p>Creates a <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> to set and display two double or int
properties, which will usually represent X and Y coordinates, and
their associated unit property.</p>
<div class="refsect3">
<a name="gimp-prop-coordinates-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x_property_name</p></td>
<td class="parameter_description"><p>Name of int or double property for X coordinate.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y_property_name</p></td>
<td class="parameter_description"><p>Name of int or double property for Y coordinate.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>unit_property_name</p></td>
<td class="parameter_description"><p>Name of unit property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>unit_format</p></td>
<td class="parameter_description"><p>A printf-like unit-format string as is used with
<a href="/local/head/share/gtk-doc/html/libgimpwidgets/GimpUnitMenu.html#gimp-unit-menu-new"><code class="function">gimp_unit_menu_new()</code></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>update_policy</p></td>
<td class="parameter_description"><p>How the automatic pixel &lt;-&gt; real-world-unit
calculations should be done.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>xresolution</p></td>
<td class="parameter_description"><p>The resolution (in dpi) for the X coordinate.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>yresolution</p></td>
<td class="parameter_description"><p>The resolution (in dpi) for the Y coordinate.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>has_chainbutton</p></td>
<td class="parameter_description"><p>Whether to add a chainbutton to the size entry.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-coordinates-new.returns"></a><h4>Returns</h4>
<p>A new <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-entry-new"></a><h3>gimp_prop_entry_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_entry_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                     <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                     <em class="parameter"><code><span class="type">gint</span> max_len</code></em>);</pre>
<p>Creates a <a href="https://developer.gnome.org/gtk3/GtkEntry.html#GtkEntry-struct"><span class="type">GtkEntry</span></a> to set and display the value of the specified
string property.</p>
<div class="refsect3">
<a name="gimp-prop-entry-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of string property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>max_len</p></td>
<td class="parameter_description"><p>Maximum allowed length of string.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-entry-new.returns"></a><h4>Returns</h4>
<p>A new <a href="https://developer.gnome.org/gtk3/GtkEntry.html#GtkEntry-struct"><span class="type">GtkEntry</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-pointer-combo-box-new"></a><h3>gimp_prop_pointer_combo_box_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_pointer_combo_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                                 <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                                 <em class="parameter"><code><a class="link" href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> *store</code></em>);</pre>
<p>Creates a <a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget to display and set the specified
property.  The contents of the widget are determined by <em class="parameter"><code>store</code></em>
,
which should be created using <a class="link" href="GimpIntStore.html#gimp-int-store-new" title="gimp_int_store_new ()"><code class="function">gimp_int_store_new()</code></a>.
Values are GType/gpointer data, and therefore must be stored in the
"user-data" column, instead of the usual "value" column.</p>
<div class="refsect3">
<a name="gimp-prop-pointer-combo-box-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of GType/gpointer property controlled by combo box.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>store</p></td>
<td class="parameter_description"><p><a class="link" href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> holding list of labels, values, etc.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-pointer-combo-box-new.returns"></a><h4>Returns</h4>
<p>The newly created <a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-enum-check-button-new"></a><h3>gimp_prop_enum_check_button_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_enum_check_button_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                                 <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                                 <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>,
                                 <em class="parameter"><code><span class="type">gint</span> false_value</code></em>,
                                 <em class="parameter"><code><span class="type">gint</span> true_value</code></em>);</pre>
<p>Creates a <a href="https://developer.gnome.org/gtk3/GtkCheckButton.html#GtkCheckButton-struct"><span class="type">GtkCheckButton</span></a> that displays and sets the specified
property of type Enum.  Note that this widget only allows two values
for the enum, one corresponding to the "checked" state and the
other to the "unchecked" state.
If <em class="parameter"><code>label</code></em>
 is <code class="literal">NULL</code>, the <em class="parameter"><code>property_name</code></em>
's nick will be used as label
of the returned button.</p>
<div class="refsect3">
<a name="gimp-prop-enum-check-button-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of enum property controlled by checkbutton.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>Label to give checkbutton (including mnemonic). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>false_value</p></td>
<td class="parameter_description"><p>Enum value corresponding to unchecked state.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>true_value</p></td>
<td class="parameter_description"><p>Enum value corresponding to checked state.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-enum-check-button-new.returns"></a><h4>Returns</h4>
<p>The newly created <a href="https://developer.gnome.org/gtk3/GtkCheckButton.html#GtkCheckButton-struct"><span class="type">GtkCheckButton</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-enum-combo-box-new"></a><h3>gimp_prop_enum_combo_box_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_enum_combo_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                              <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                              <em class="parameter"><code><span class="type">gint</span> minimum</code></em>,
                              <em class="parameter"><code><span class="type">gint</span> maximum</code></em>);</pre>
<p>Creates a <a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget to display and set the specified
enum property.  The <em class="parameter"><code>mimimum_value</code></em>
 and <em class="parameter"><code>maximum_value</code></em>
 give the
possibility of restricting the allowed range to a subset of the
enum.  If the two values are equal (e.g., 0, 0), then the full
range of the Enum is used.</p>
<div class="refsect3">
<a name="gimp-prop-enum-combo-box-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of enum property controlled by combo box.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>minimum</p></td>
<td class="parameter_description"><p>Smallest allowed value of enum.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>maximum</p></td>
<td class="parameter_description"><p>Largest allowed value of enum.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-enum-combo-box-new.returns"></a><h4>Returns</h4>
<p>The newly created <a class="link" href="GimpEnumComboBox.html" title="GimpEnumComboBox"><span class="type">GimpEnumComboBox</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-enum-label-new"></a><h3>gimp_prop_enum_label_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_enum_label_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                          <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</pre>
<div class="refsect3">
<a name="gimp-prop-enum-label-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of enum property to be displayed.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-enum-label-new.returns"></a><h4>Returns</h4>
<p>The newly created <a class="link" href="GimpEnumLabel.html" title="GimpEnumLabel"><span class="type">GimpEnumLabel</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-enum-radio-box-new"></a><h3>gimp_prop_enum_radio_box_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_enum_radio_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                              <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                              <em class="parameter"><code><span class="type">gint</span> minimum</code></em>,
                              <em class="parameter"><code><span class="type">gint</span> maximum</code></em>);</pre>
<p>Creates a group of radio buttons which function to set and display
the specified enum property.  The <em class="parameter"><code>minimum</code></em>
 and <em class="parameter"><code>maximum</code></em>
 arguments
allow only a subset of the enum to be used.  If the two arguments
are equal (e.g., 0, 0), then the full range of the enum will be used.
If you want to assign a label to the group of radio buttons, use
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-enum-radio-frame-new" title="gimp_prop_enum_radio_frame_new ()"><code class="function">gimp_prop_enum_radio_frame_new()</code></a> instead of this function.</p>
<div class="refsect3">
<a name="gimp-prop-enum-radio-box-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of enum property controlled by the radio buttons.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>minimum</p></td>
<td class="parameter_description"><p>Smallest value of enum to be included.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>maximum</p></td>
<td class="parameter_description"><p>Largest value of enum to be included.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-enum-radio-box-new.returns"></a><h4>Returns</h4>
<p>A <a href="https://developer.gnome.org/gtk3/GtkBox.html#GtkBox-struct"><span class="type">GtkBox</span></a> containing the radio buttons. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-enum-radio-frame-new"></a><h3>gimp_prop_enum_radio_frame_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_enum_radio_frame_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                                <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                                <em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>,
                                <em class="parameter"><code><span class="type">gint</span> minimum</code></em>,
                                <em class="parameter"><code><span class="type">gint</span> maximum</code></em>);</pre>
<p>Creates a group of radio buttons which function to set and display
the specified enum property.  The <em class="parameter"><code>minimum</code></em>
 and <em class="parameter"><code>maximum</code></em>
 arguments
allow only a subset of the enum to be used.  If the two arguments
are equal (e.g., 0, 0), then the full range of the enum will be used.
If <em class="parameter"><code>title</code></em>
 is <code class="literal">NULL</code>, the <em class="parameter"><code>property_name</code></em>
's nick will be used as label
of the returned frame.</p>
<div class="refsect3">
<a name="gimp-prop-enum-radio-frame-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of enum property controlled by the radio buttons.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>title</p></td>
<td class="parameter_description"><p>Label for the frame holding the buttons. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>minimum</p></td>
<td class="parameter_description"><p>Smallest value of enum to be included.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>maximum</p></td>
<td class="parameter_description"><p>Largest value of enum to be included.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-enum-radio-frame-new.returns"></a><h4>Returns</h4>
<p>A <a class="link" href="GimpFrame.html" title="GimpFrame"><span class="type">GimpFrame</span></a> containing the radio buttons. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-enum-icon-box-new"></a><h3>gimp_prop_enum_icon_box_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_enum_icon_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                             <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                             <em class="parameter"><code>const <span class="type">gchar</span> *icon_prefix</code></em>,
                             <em class="parameter"><code><span class="type">gint</span> minimum</code></em>,
                             <em class="parameter"><code><span class="type">gint</span> maximum</code></em>);</pre>
<p>Creates a horizontal box of radio buttons with named icons, which
function to set and display the value of the specified Enum
property.  The icon name for each icon is created by appending the
enum_value's nick to the given <em class="parameter"><code>icon_prefix</code></em>
.  See
<a class="link" href="libgimpwidgets3-GimpEnumWidgets.html#gimp-enum-icon-box-new" title="gimp_enum_icon_box_new ()"><code class="function">gimp_enum_icon_box_new()</code></a> for more information.</p>
<div class="refsect3">
<a name="gimp-prop-enum-icon-box-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of enum property controlled by the radio buttons.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_prefix</p></td>
<td class="parameter_description"><p>The prefix of the group of icon names to use.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>minimum</p></td>
<td class="parameter_description"><p>Smallest value of enum to be included.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>maximum</p></td>
<td class="parameter_description"><p>Largest value of enum to be included.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-enum-icon-box-new.returns"></a><h4>Returns</h4>
<p>A <span class="type">libgimpwidgets-gimpenumiconbox</span> containing the radio buttons. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-expander-new"></a><h3>gimp_prop_expander_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_expander_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                        <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                        <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
<p>Creates a <a href="https://developer.gnome.org/gtk3/GtkExpander.html#GtkExpander-struct"><span class="type">GtkExpander</span></a> controlled by the specified boolean property.
A value of <code class="literal">TRUE</code> for the property corresponds to the expanded state
for the widget.
If <em class="parameter"><code>label</code></em>
 is <code class="literal">NULL</code>, the <em class="parameter"><code>property_name</code></em>
's nick will be used as label
of the returned widget.</p>
<div class="refsect3">
<a name="gimp-prop-expander-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of boolean property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>Label for expander. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-expander-new.returns"></a><h4>Returns</h4>
<p>A new <a href="https://developer.gnome.org/gtk3/GtkExpander.html#GtkExpander-struct"><span class="type">GtkExpander</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-file-chooser-button-new"></a><h3>gimp_prop_file_chooser_button_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_file_chooser_button_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                                   <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                                   <em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>,
                                   <em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkFileChooser.html#GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a> action</code></em>);</pre>
<p>Creates a <a href="https://developer.gnome.org/gtk3/GtkFileChooserButton.html#GtkFileChooserButton-struct"><span class="type">GtkFileChooserButton</span></a> to edit the specified path property.</p>
<p>Note that <a href="https://developer.gnome.org/gtk3/GtkFileChooserButton.html#GtkFileChooserButton-struct"><span class="type">GtkFileChooserButton</span></a> implements the <a href="https://developer.gnome.org/gtk3/GtkFileChooser.html#GtkFileChooser-struct"><span class="type">GtkFileChooser</span></a>
interface; you can use the <a href="https://developer.gnome.org/gtk3/GtkFileChooser.html#GtkFileChooser-struct"><span class="type">GtkFileChooser</span></a> API with it.</p>
<div class="refsect3">
<a name="gimp-prop-file-chooser-button-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>name of path property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>title</p></td>
<td class="parameter_description"><p>the title of the browse dialog.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the open mode for the widget.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-file-chooser-button-new.returns"></a><h4>Returns</h4>
<p>A new <a href="https://developer.gnome.org/gtk3/GtkFileChooserButton.html#GtkFileChooserButton-struct"><span class="type">GtkFileChooserButton</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-file-chooser-button-new-with-dialog"></a><h3>gimp_prop_file_chooser_button_new_with_dialog ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_file_chooser_button_new_with_dialog
                               (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                                <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                                <em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *dialog</code></em>);</pre>
<p>Creates a <a href="https://developer.gnome.org/gtk3/GtkFileChooserButton.html#GtkFileChooserButton-struct"><span class="type">GtkFileChooserButton</span></a> to edit the specified path property.</p>
<p>The button uses <em class="parameter"><code>dialog</code></em>
 as it's file-picking window. Note that <em class="parameter"><code>dialog</code></em>

must be a <a href="https://developer.gnome.org/gtk3/GtkFileChooserDialog.html#GtkFileChooserDialog-struct"><span class="type">GtkFileChooserDialog</span></a> (or subclass) and must not have
<a href="https://developer.gnome.org/gtk3/GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS"><code class="literal">GTK_DIALOG_DESTROY_WITH_PARENT</code></a> set.</p>
<p>Note that <a href="https://developer.gnome.org/gtk3/GtkFileChooserButton.html#GtkFileChooserButton-struct"><span class="type">GtkFileChooserButton</span></a> implements the <a href="https://developer.gnome.org/gtk3/GtkFileChooser.html#GtkFileChooser-struct"><span class="type">GtkFileChooser</span></a>
interface; you can use the <a href="https://developer.gnome.org/gtk3/GtkFileChooser.html#GtkFileChooser-struct"><span class="type">GtkFileChooser</span></a> API with it.</p>
<div class="refsect3">
<a name="gimp-prop-file-chooser-button-new-with-dialog.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>name of path property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>dialog</p></td>
<td class="parameter_description"><p>the <a href="https://developer.gnome.org/gtk3/GtkFileChooserDialog.html#GtkFileChooserDialog-struct"><span class="type">GtkFileChooserDialog</span></a> widget to use.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-file-chooser-button-new-with-dialog.returns"></a><h4>Returns</h4>
<p>A new <a href="https://developer.gnome.org/gtk3/GtkFileChooserButton.html#GtkFileChooserButton-struct"><span class="type">GtkFileChooserButton</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-hscale-new"></a><h3>gimp_prop_hscale_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_hscale_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                      <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                      <em class="parameter"><code><span class="type">gdouble</span> step_increment</code></em>,
                      <em class="parameter"><code><span class="type">gdouble</span> page_increment</code></em>,
                      <em class="parameter"><code><span class="type">gint</span> digits</code></em>);</pre>
<p>Creates a horizontal scale to control the value of the specified
integer or double property.</p>
<div class="refsect3">
<a name="gimp-prop-hscale-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of integer or double property controlled by the scale.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>step_increment</p></td>
<td class="parameter_description"><p>Step size.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>page_increment</p></td>
<td class="parameter_description"><p>Page size.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>digits</p></td>
<td class="parameter_description"><p>Number of digits after decimal point to display.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-hscale-new.returns"></a><h4>Returns</h4>
<p>A new <a href="https://developer.gnome.org/gtk3/GtkScale.html#GtkScale-struct"><span class="type">GtkScale</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-icon-image-new"></a><h3>gimp_prop_icon_image_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_icon_image_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                          <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                          <em class="parameter"><code><a href="https://developer.gnome.org/gtk3/gtk3-Themeable-Stock-Images.html#GtkIconSize"><span class="type">GtkIconSize</span></a> icon_size</code></em>);</pre>
<p>Creates a widget to display a icon image representing the value of the
specified string property, which should encode an icon name.
See <a href="https://developer.gnome.org/gtk3/GtkImage.html#gtk-image-new-from-icon-name"><code class="function">gtk_image_new_from_icon_name()</code></a> for more information.</p>
<div class="refsect3">
<a name="gimp-prop-icon-image-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of string property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_size</p></td>
<td class="parameter_description"><p>Size of desired icon image.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-icon-image-new.returns"></a><h4>Returns</h4>
<p>A new <a href="https://developer.gnome.org/gtk3/GtkImage.html#GtkImage-struct"><span class="type">GtkImage</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-int-combo-box-new"></a><h3>gimp_prop_int_combo_box_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_int_combo_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                             <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                             <em class="parameter"><code><a class="link" href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> *store</code></em>);</pre>
<p>Creates a <a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget to display and set the specified
property.  The contents of the widget are determined by <em class="parameter"><code>store</code></em>
,
which should be created using <a class="link" href="GimpIntStore.html#gimp-int-store-new" title="gimp_int_store_new ()"><code class="function">gimp_int_store_new()</code></a>.</p>
<div class="refsect3">
<a name="gimp-prop-int-combo-box-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of int property controlled by combo box.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>store</p></td>
<td class="parameter_description"><p><a class="link" href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> holding list of labels, values, etc.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-int-combo-box-new.returns"></a><h4>Returns</h4>
<p>The newly created <a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-int-radio-frame-new"></a><h3>gimp_prop_int_radio_frame_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_int_radio_frame_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                               <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                               <em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>,
                               <em class="parameter"><code><a class="link" href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> *store</code></em>);</pre>
<p>Creates a group of radio buttons which function to set and display
the specified int property. If <em class="parameter"><code>title</code></em>
 is <code class="literal">NULL</code>, the
<em class="parameter"><code>property_name</code></em>
's nick will be used as label of the returned frame.</p>
<div class="refsect3">
<a name="gimp-prop-int-radio-frame-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of enum property controlled by the radio buttons.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>title</p></td>
<td class="parameter_description"><p>Label for the frame holding the buttons. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>store</p></td>
<td class="parameter_description"><p><a class="link" href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> holding list of labels, values, etc.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-int-radio-frame-new.returns"></a><h4>Returns</h4>
<p>A <a class="link" href="GimpFrame.html" title="GimpFrame"><span class="type">GimpFrame</span></a> containing the radio buttons. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-int-radio-box-new"></a><h3>gimp_prop_int_radio_box_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_int_radio_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                             <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                             <em class="parameter"><code><a class="link" href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> *store</code></em>);</pre>
<p>Creates a group of radio buttons which function to set and display
the specified int property. If you want to assign a label to the
group of radio buttons, use <a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-int-radio-frame-new" title="gimp_prop_int_radio_frame_new ()"><code class="function">gimp_prop_int_radio_frame_new()</code></a>
instead of this function.</p>
<div class="refsect3">
<a name="gimp-prop-int-radio-box-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of enum property controlled by the radio buttons.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>store</p></td>
<td class="parameter_description"><p><a class="link" href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> holding list of labels, values, etc.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-int-radio-box-new.returns"></a><h4>Returns</h4>
<p>A <a href="https://developer.gnome.org/gtk3/GtkBox.html#GtkBox-struct"><span class="type">GtkBox</span></a> containing the radio buttons. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-label-new"></a><h3>gimp_prop_label_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_label_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                     <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</pre>
<p>Creates a <a href="https://developer.gnome.org/gtk3/GtkLabel.html#GtkLabel-struct"><span class="type">GtkLabel</span></a> to display the value of the specified property.
The property should be a string property or at least transformable
to a string.  If the user should be able to edit the string, use
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-entry-new" title="gimp_prop_entry_new ()"><code class="function">gimp_prop_entry_new()</code></a> instead.</p>
<div class="refsect3">
<a name="gimp-prop-label-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of string property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-label-new.returns"></a><h4>Returns</h4>
<p>A new <a href="https://developer.gnome.org/gtk3/GtkLabel.html#GtkLabel-struct"><span class="type">GtkLabel</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-memsize-entry-new"></a><h3>gimp_prop_memsize_entry_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_memsize_entry_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                             <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</pre>
<p>Creates a <a class="link" href="GimpMemsizeEntry.html" title="GimpMemSizeEntry"><span class="type">GimpMemsizeEntry</span></a> (spin button and option menu) to set
and display the value of the specified memsize property.  See
<a class="link" href="GimpMemsizeEntry.html#gimp-memsize-entry-new" title="gimp_memsize_entry_new ()"><code class="function">gimp_memsize_entry_new()</code></a> for more information.</p>
<div class="refsect3">
<a name="gimp-prop-memsize-entry-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of memsize property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-memsize-entry-new.returns"></a><h4>Returns</h4>
<p>A new <a class="link" href="GimpMemsizeEntry.html" title="GimpMemSizeEntry"><span class="type">GimpMemsizeEntry</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-opacity-entry-new"></a><h3>gimp_prop_opacity_entry_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkAdjustment.html#GtkAdjustment-struct"><span class="returnvalue">GtkAdjustment</span></a> *
gimp_prop_opacity_entry_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                             <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                             <em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkGrid.html#GtkGrid-struct"><span class="type">GtkGrid</span></a> *grid</code></em>,
                             <em class="parameter"><code><span class="type">gint</span> column</code></em>,
                             <em class="parameter"><code><span class="type">gint</span> row</code></em>,
                             <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
<p>Creates a <span class="type">libgimpwidgets-gimpscaleentry</span> (slider and spin button)
to set and display the value of the specified double property,
which should represent an "opacity" variable with range 0 to 100.
See <a class="link" href="libgimpwidgets3-GimpWidgets.html#gimp-scale-entry-new" title="gimp_scale_entry_new ()"><code class="function">gimp_scale_entry_new()</code></a> for more information.</p>
<div class="refsect3">
<a name="gimp-prop-opacity-entry-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of double property controlled by the spin button.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>grid</p></td>
<td class="parameter_description"><p>The <a href="https://developer.gnome.org/gtk3/GtkGrid.html#GtkGrid-struct"><span class="type">GtkGrid</span></a> the widgets will be attached to.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>column</p></td>
<td class="parameter_description"><p>The column to start with.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>row</p></td>
<td class="parameter_description"><p>The row to attach the widgets.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>The text for the <a href="https://developer.gnome.org/gtk3/GtkLabel.html#GtkLabel-struct"><span class="type">GtkLabel</span></a> which will appear left of the
<a href="https://developer.gnome.org/gtk3/GtkHScale.html#GtkHScale-struct"><span class="type">GtkHScale</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-opacity-entry-new.returns"></a><h4>Returns</h4>
<p>The <a href="https://developer.gnome.org/gtk3/GtkSpinButton.html#GtkSpinButton-struct"><span class="type">GtkSpinButton</span></a>'s <a href="https://developer.gnome.org/gtk3/GtkAdjustment.html#GtkAdjustment-struct"><span class="type">GtkAdjustment</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-path-editor-new"></a><h3>gimp_prop_path_editor_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_path_editor_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *path_property_name</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *writable_property_name</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *filechooser_title</code></em>);</pre>
<p>Creates a <a class="link" href="GimpPathEditor.html" title="GimpPathEditor"><span class="type">GimpPathEditor</span></a> to edit the specified path and writable
path properties.</p>
<div class="refsect3">
<a name="gimp-prop-path-editor-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path_property_name</p></td>
<td class="parameter_description"><p>name of path property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>writable_property_name</p></td>
<td class="parameter_description"><p>name of writable path property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>filechooser_title</p></td>
<td class="parameter_description"><p>window title of <a href="https://developer.gnome.org/gtk3/GtkFileChooserDialog.html#GtkFileChooserDialog-struct"><span class="type">GtkFileChooserDialog</span></a> widget.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-path-editor-new.returns"></a><h4>Returns</h4>
<p>A new <a class="link" href="GimpPathEditor.html" title="GimpPathEditor"><span class="type">GimpPathEditor</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-scale-entry-new"></a><h3>gimp_prop_scale_entry_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkAdjustment.html#GtkAdjustment-struct"><span class="returnvalue">GtkAdjustment</span></a> *
gimp_prop_scale_entry_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                           <em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkGrid.html#GtkGrid-struct"><span class="type">GtkGrid</span></a> *grid</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> column</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> row</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>,
                           <em class="parameter"><code><span class="type">gdouble</span> step_increment</code></em>,
                           <em class="parameter"><code><span class="type">gdouble</span> page_increment</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> digits</code></em>,
                           <em class="parameter"><code><span class="type">gboolean</span> limit_scale</code></em>,
                           <em class="parameter"><code><span class="type">gdouble</span> lower_limit</code></em>,
                           <em class="parameter"><code><span class="type">gdouble</span> upper_limit</code></em>);</pre>
<p>Creates a <span class="type">libgimpwidgets-gimpscaleentry</span> (slider and spin button)
to set and display the value of the specified double property.  See
<a class="link" href="libgimpwidgets3-GimpWidgets.html#gimp-scale-entry-new" title="gimp_scale_entry_new ()"><code class="function">gimp_scale_entry_new()</code></a> for more information.
If <em class="parameter"><code>label</code></em>
 is <code class="literal">NULL</code>, the <em class="parameter"><code>property_name</code></em>
's nick will be used as label
of the returned object.</p>
<p>Note that the <em class="parameter"><code>scale_limits</code></em>
 boolean is the inverse of
<a class="link" href="libgimpwidgets3-GimpWidgets.html#gimp-scale-entry-new" title="gimp_scale_entry_new ()"><code class="function">gimp_scale_entry_new()</code></a>'s "constrain" parameter.</p>
<div class="refsect3">
<a name="gimp-prop-scale-entry-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of double property controlled by the spin button.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>grid</p></td>
<td class="parameter_description"><p>The <a href="https://developer.gnome.org/gtk3/GtkGrid.html#GtkGrid-struct"><span class="type">GtkGrid</span></a> the widgets will be attached to.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>column</p></td>
<td class="parameter_description"><p>The column to start with.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>row</p></td>
<td class="parameter_description"><p>The row to attach the widgets.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>The text for the <a href="https://developer.gnome.org/gtk3/GtkLabel.html#GtkLabel-struct"><span class="type">GtkLabel</span></a> which will appear left of
the <a href="https://developer.gnome.org/gtk3/GtkHScale.html#GtkHScale-struct"><span class="type">GtkHScale</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>step_increment</p></td>
<td class="parameter_description"><p>Step size.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>page_increment</p></td>
<td class="parameter_description"><p>Page size.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>digits</p></td>
<td class="parameter_description"><p>Number of digits after decimal point to display.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>limit_scale</p></td>
<td class="parameter_description"><p><code class="literal">FALSE</code> if the range of possible values of the
GtkHScale should be the same as of the GtkSpinButton.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>lower_limit</p></td>
<td class="parameter_description"><p>The scale's lower boundary if <em class="parameter"><code>scale_limits</code></em>
is <code class="literal">TRUE</code>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>upper_limit</p></td>
<td class="parameter_description"><p>The scale's upper boundary if <em class="parameter"><code>scale_limits</code></em>
is <code class="literal">TRUE</code>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-scale-entry-new.returns"></a><h4>Returns</h4>
<p>The <a href="https://developer.gnome.org/gtk3/GtkSpinButton.html#GtkSpinButton-struct"><span class="type">GtkSpinButton</span></a>'s <a href="https://developer.gnome.org/gtk3/GtkAdjustment.html#GtkAdjustment-struct"><span class="type">GtkAdjustment</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-size-entry-new"></a><h3>gimp_prop_size_entry_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_size_entry_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                          <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                          <em class="parameter"><code><span class="type">gboolean</span> property_is_pixel</code></em>,
                          <em class="parameter"><code>const <span class="type">gchar</span> *unit_property_name</code></em>,
                          <em class="parameter"><code>const <span class="type">gchar</span> *unit_format</code></em>,
                          <em class="parameter"><code><a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy"><span class="type">GimpSizeEntryUpdatePolicy</span></a> update_policy</code></em>,
                          <em class="parameter"><code><span class="type">gdouble</span> resolution</code></em>);</pre>
<p>Creates a <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> to set and display the specified double or
int property, and its associated unit property.  Note that this
function is only suitable for creating a size entry holding a
single value.  Use <a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-coordinates-new" title="gimp_prop_coordinates_new ()"><code class="function">gimp_prop_coordinates_new()</code></a> to create a size
entry holding two values.</p>
<div class="refsect3">
<a name="gimp-prop-size-entry-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of int or double property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_is_pixel</p></td>
<td class="parameter_description"><p>When <code class="literal">TRUE</code>, the property value is in pixels,
and in the selected unit otherwise.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>unit_property_name</p></td>
<td class="parameter_description"><p>Name of unit property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>unit_format</p></td>
<td class="parameter_description"><p>A printf-like unit-format string as is used with
<a href="/local/head/share/gtk-doc/html/libgimpwidgets/GimpUnitMenu.html#gimp-unit-menu-new"><code class="function">gimp_unit_menu_new()</code></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>update_policy</p></td>
<td class="parameter_description"><p>How the automatic pixel &lt;-&gt; real-world-unit
calculations should be done.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>resolution</p></td>
<td class="parameter_description"><p>The resolution (in dpi) for the field.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-size-entry-new.returns"></a><h4>Returns</h4>
<p>A new <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-spin-button-new"></a><h3>gimp_prop_spin_button_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_spin_button_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                           <em class="parameter"><code><span class="type">gdouble</span> step_increment</code></em>,
                           <em class="parameter"><code><span class="type">gdouble</span> page_increment</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> digits</code></em>);</pre>
<p>Creates a spin button to set and display the value of the
specified double property.</p>
<div class="refsect3">
<a name="gimp-prop-spin-button-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of double property controlled by the spin button.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>step_increment</p></td>
<td class="parameter_description"><p>Step size.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>page_increment</p></td>
<td class="parameter_description"><p>Page size.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>digits</p></td>
<td class="parameter_description"><p>Number of digits after decimal point to display.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-spin-button-new.returns"></a><h4>Returns</h4>
<p>A new <span class="type">libgimpwidgets-gimpspinbutton</span>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-string-combo-box-new"></a><h3>gimp_prop_string_combo_box_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_string_combo_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                                <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                                <em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkTreeModel.html#GtkTreeModel-struct"><span class="type">GtkTreeModel</span></a> *model</code></em>,
                                <em class="parameter"><code><span class="type">gint</span> id_column</code></em>,
                                <em class="parameter"><code><span class="type">gint</span> label_column</code></em>);</pre>
<p>Creates a <a class="link" href="GimpStringComboBox.html" title="GimpStringComboBox"><span class="type">GimpStringComboBox</span></a> widget to display and set the
specified property.  The contents of the widget are determined by
<em class="parameter"><code>store</code></em>
.</p>
<div class="refsect3">
<a name="gimp-prop-string-combo-box-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of int property controlled by combo box.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>model</p></td>
<td class="parameter_description"><p><a href="https://developer.gnome.org/gtk3/GtkTreeStore.html#GtkTreeStore-struct"><span class="type">GtkTreeStore</span></a> holding list of values</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>id_column</p></td>
<td class="parameter_description"><p>column in <em class="parameter"><code>store</code></em>
that holds string IDs</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>label_column</p></td>
<td class="parameter_description"><p>column in <em class="parameter"><code>store</code></em>
that holds labels to use in the combo-box</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-string-combo-box-new.returns"></a><h4>Returns</h4>
<p>The newly created <a class="link" href="GimpStringComboBox.html" title="GimpStringComboBox"><span class="type">GimpStringComboBox</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-switch-new"></a><h3>gimp_prop_switch_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_switch_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                      <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                      <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>,
                      <em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> **label_out</code></em>,
                      <em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> **switch_out</code></em>);</pre>
<p>Creates a <a href="https://developer.gnome.org/gtk3/GtkBox.html#GtkBox-struct"><span class="type">GtkBox</span></a> with a switch and a label that displays and sets the
specified boolean property.
If <em class="parameter"><code>label</code></em>
 is <code class="literal">NULL</code>, the <em class="parameter"><code>property_name</code></em>
's nick will be used as label.</p>
<div class="refsect3">
<a name="gimp-prop-switch-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of boolean property controlled by checkbutton.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>Label to give checkbutton (including mnemonic).</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>label_out</p></td>
<td class="parameter_description"><p>The generated <a href="https://developer.gnome.org/gtk3/GtkLabel.html#GtkLabel-struct"><span class="type">GtkLabel</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>switch_out</p></td>
<td class="parameter_description"><p>The generated <a href="https://developer.gnome.org/gtk3/GtkSwitch.html#GtkSwitch-struct"><span class="type">GtkSwitch</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-switch-new.returns"></a><h4>Returns</h4>
<p>The newly created box containing a <a href="https://developer.gnome.org/gtk3/GtkSwitch.html#GtkSwitch-struct"><span class="type">GtkSwitch</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-text-buffer-new"></a><h3>gimp_prop_text_buffer_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkTextBuffer.html#GtkTextBuffer-struct"><span class="returnvalue">GtkTextBuffer</span></a> *
gimp_prop_text_buffer_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> max_len</code></em>);</pre>
<p>Creates a <a href="https://developer.gnome.org/gtk3/GtkTextBuffer.html#GtkTextBuffer-struct"><span class="type">GtkTextBuffer</span></a> to set and display the value of the
specified string property.  Unless the string is expected to
contain multiple lines or a large amount of text, use
<a class="link" href="libgimpwidgets3-GimpPropWidgets.html#gimp-prop-entry-new" title="gimp_prop_entry_new ()"><code class="function">gimp_prop_entry_new()</code></a> instead.  See <a href="https://developer.gnome.org/gtk3/GtkTextView.html#GtkTextView-struct"><span class="type">GtkTextView</span></a> for information on
how to insert a text buffer into a visible widget.</p>
<p>If <em class="parameter"><code>max_len</code></em>
 is 0 or negative, the text buffer allows an unlimited
number of characters to be entered.</p>
<div class="refsect3">
<a name="gimp-prop-text-buffer-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of string property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>max_len</p></td>
<td class="parameter_description"><p>Maximum allowed length of text (in characters).</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-text-buffer-new.returns"></a><h4>Returns</h4>
<p>A new <a href="https://developer.gnome.org/gtk3/GtkTextBuffer.html#GtkTextBuffer-struct"><span class="type">GtkTextBuffer</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-prop-unit-combo-box-new"></a><h3>gimp_prop_unit_combo_box_new ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
gimp_prop_unit_combo_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>,
                              <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</pre>
<p>Creates a <a class="link" href="GimpUnitComboBox.html" title="GimpUnitComboBox"><span class="type">GimpUnitComboBox</span></a> to set and display the value of a Unit
property.  See <a class="link" href="GimpUnitComboBox.html#gimp-unit-combo-box-new" title="gimp_unit_combo_box_new ()"><code class="function">gimp_unit_combo_box_new()</code></a> for more information.</p>
<div class="refsect3">
<a name="gimp-prop-unit-combo-box-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>config</p></td>
<td class="parameter_description"><p>Object to which property is attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>Name of Unit property.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-prop-unit-combo-box-new.returns"></a><h4>Returns</h4>
<p>A new <a class="link" href="GimpUnitComboBox.html" title="GimpUnitComboBox"><span class="type">GimpUnitComboBox</span></a> widget. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.0</div>
</body>
</html>